home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 44 / Amiga Format CD44 (1999-08-26)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-10].iso / -in_the_mag- / basics / blitz / bdchunkylib.lha / BDChunkyLib.readme < prev   
Text File  |  1998-05-20  |  3KB  |  125 lines
  1. ;--------------------------------------------------------
  2.  
  3.  
  4.      BDChunkyLib  V1.0  (C) BadDolls Production
  5.  
  6.      20/05/1998
  7.  
  8. ;--------------------------------------------------------
  9. ; How to install it, if you need another lib's number :
  10. ;
  11. ; First : Change the value of #bdchklib to a free number.
  12. ; ------  ( Have a look to DefLibMan in BUM9 )
  13. ;
  14. ; Second: Make blitzlibs:libmacs.res resident
  15. ; ------  ,select only 'Make Smallest Code'
  16. ;         in the Compiler Options
  17. ;         and create an executable ( BDChunkyLib.obj )
  18. ;
  19. ; Third : Remake your Deflibs ( via DefLibMan for example )
  20. ; ------
  21. ;________________________________________________________
  22.  
  23.  
  24.  
  25. First, there is a new object call "NChunky". This is a Chunky Buffer ;-)
  26.  
  27. The structure of this object is :
  28.  
  29. NEWTYPE.NChunky
  30.   Width.l       ; Width of picture
  31.   Height.l      ; Height of picture
  32.   Size.l        ; Size of buffer
  33.   AWidth.l      ; Aligned Width for buffer
  34.   *ChunkyData.b ; Addr of the real chunky buffer
  35. End NEWTYPE
  36.  
  37.  
  38. The commands are :
  39.  
  40.  o  InitNChunky NChunky#,Width.l,Height.l  
  41.       
  42.     This command simply init the chunky buffer NChunky#.
  43.     When use as a command, it return the address of the object.
  44.  
  45.  o  *AddrNChunky.NChunky=InitNChunky Width.l,Height.l
  46.  
  47.     This can be useful when you need a lot of NChunky buffers
  48.      and don't want to assign them to a number. ( I need this in
  49.      XLabProcess ;-)  )
  50.  
  51.  o  NChunkyToBtmA *AddrNChunky.l, *AddrBtm.l
  52.  
  53.     NChunkyToBtm  NChunky#, BitMap#
  54.  
  55.     Convert a NChunky to BitMap ( same size !!! )
  56.  
  57.  
  58.  o  BtmToNChunkyA *AddrBtm.l *AddrNChunky.l
  59.  
  60.     BtmToNChunky BitMap#, NChunky#
  61.  
  62.     Convert a BitMap to a NChunky ( same size !!! )
  63.  
  64.  
  65.  o   NCPlotA *AddrNChunky.l, x.l, y.l, colour.b
  66.  
  67.     NCPlot NChunky#, x.l, y.l, colour.b
  68.  
  69.      Just like the Plot command ;-)
  70.  
  71.  
  72.  o   colour.b = NCPointA( *AddrNChunky.l, x.l, y.l )
  73.  
  74.      colour.b = NCPoint( NChunky#, x.l, y.l )
  75.  
  76.      Just like the Point command...
  77.  
  78.  
  79.  o   NCBoxFA *AddrNChunky.l, x1.l, y1.l ,x2.l ,y2.l ,colour.b
  80.  
  81.      NCBoxF NChunky#, x1.l, y1.l, x2.l, y2.l, colour.b
  82.  
  83.      Just like the BoxF command...
  84.  
  85.  
  86.  o   CopyNChunkyA *AddrNChunkySrc.l, *AddrNChunkyDest.l
  87.  
  88.     CopyNChunky NChunkySrc#, NChunkyDest#
  89.  
  90.      Will copy the NChunkySrc to the NChunkyDest.
  91.  
  92.  
  93.  o   NCClsA *AddrNChunky.l ,colour.b
  94.  
  95.     NCCls NChunky# [,colour.b ]
  96.  
  97.      Hummm, like Cls...
  98.  
  99.  
  100.  o   FreeNChunkyA *AddrNChunky.l
  101.  
  102.      Free a NChunky buffer.
  103.      
  104.      ONLY USE THIS IF YOU HAVE USE THE InitNChunkyA COMMAND !!!
  105.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  106.  
  107.  o   RemapNChunkyLineA *AddrNChunky.l ,y.l ,&RemapTable(0).l
  108.  
  109.      RemapNChunkyLine NChunky# ,y.l ,&RemapTable(0).l
  110.  
  111.      Simply Remap the line 'y' of your NChunky, using a color table.
  112.  
  113.     RemapTable() is a table for converting the colours.
  114.     RemapTable must be .b !!!
  115.  
  116.  
  117.  o   RemapNChunkyPointA *AddrNChunky.l ,x.l, y.l ,&RemapTable(0).l
  118.  
  119.      RemapNChunkyPoint NChunky# ,x.l, y.l ,&RemapTable(0).l
  120.  
  121.      Simply Remap the point x,y of your NChunky, using a color table.
  122.  
  123.     RemapTable() is a table for converting the colours.
  124.     RemapTable must be .b !!!
  125.